6.3.1 创建数字币限定金额扫码支付订单
#简要描述： 数字币充值业务接口，用户通过扫描二维码的方式将 USDT（Tether）充值到他们的数字钱包账户
创建支付订单
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/v1/receive/blockchain/fixed/create
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
请求参数
| 参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
|---|---|---|---|---|
| key | string | 是 | 商户 key | 平台分配商户 key |
| localOrderId | string | 是 | 商户本地订单号 | 商户本地订单号 |
| localUserId | string | 否 | 平台分配商户 | 商户号 |
| notifyUrl | string | 否 | 回调地址 | 用户下发成功后，由 API 回调商户的地址 |
| timestamp | Long | 否 | 时间戳（秒） | 获取当前时间毫秒数，除以 1000 转换为秒 |
| successRedirectUrl | string | 否 | 跳转地址 | 成功后自动跳转地址 |
| currency | string | 是 | 币种 | 计价币种(CNY、USDT、TRX、USD) |
| userCurrency | string | 是 | 币种 | 需要用户支付的币种(USDT、TRX) |
| amount | number | 是 | 金额 | 订单计价金额 |
| sign | string | 是 | 签名 | 详情见签名算法 |
请求 json 样例
{
"key": "dNNTJZpgFVWlYrVv",
"localOrderId":"1112212222",
"userCurrency":"USDT",
"currency": "USDT",
"amount":50,
"sign":"6b07ff29bed6f69b046d7762af579189"
}
支付返回 json 格式
返回 data 示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"orderId": 273719658252611,
"localUserId": null,
"localOrderId": "1112212222",
"orderType": "PAYMENT",
"orderBizType": "PAYMENT_FIXED_DIGITAL_SCAN",
"paymentUrl": "https://walletapi.minpayapp.com/fixed-amount-pay/eBKHdjBLuFXxhRDeiQyFHJgStCZ1e7N7YVFbhtEUNmFNiSdYCbK3sJqs7RM6",
"publicKey": "eBKHdjBLuFXxhRDeiQyFHJgStCZ1e7N7YVFbhtEUNmFNiSdYCbK3sJqs7RM6",
"addresses": {
"BSC": "0x46D0530db01336D5C68E5A3e54E96BDD0360d22c",
"TRON": "TSGDq5XUHboDVkPCjsHBohuGsoj8JwzhsP"
}
}
}
返回的 paymentUrl 弹出支付页面，如下图：
data 参数说明
| 参数名称 | 类型 | 必填 | 参数含义 | 备注 |
| orderId | string | 是 | 订单 ID | |
| localUserId | string | 是 | 商户本地用户 ID | |
| localOrderId | string | 是 | 商户本地订单号 | |
| orderType | enum | 是 | 订单类型 | PAYMENT:支付订单 | WITHDRAW:提款订单 |
| orderBizType | enum | 是 | 订单业务类型 | orderBizType 类型说明如下 |
| paymentUrl | string | 是 | 支付地址 | |
| publicKey | string | 是 | 密钥 | 公共访问密钥 |
| addresses | map | 是 | 链地址 |
orderBizType 类型说明：
1、PAYMENT_WALLET_SCAN Vpay钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至Vpay钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付
回调返回 json 数据
回调 data
{
"amount": 11,
"bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
"currency": "CNY",
"key": "h3cS7dBltRU4W1wD",
"localOrderId": "2820",
"merchantActualAmount": 8.86,
"merchantCurrency": "CNY",
"merchantId": 303122065665,
"merchantPaidAmount": 10.98,
"merchantUserId": "97",
"notifyTime": 1731572168370,
"orderCreateTime": 1731572133082,
"orderId": "273124814912907",
"sign": "699806308a9e055114c378671b0d2a15",
"status": "SUCCESS",
"type": "PAYMENT",
"userAmount": 1.55,
"userCurrency": "USDT"
}